home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / SCSL / sswap.z / sswap
Encoding:
Text File  |  2002-10-03  |  12.8 KB  |  265 lines

  1.  
  2.  
  3.  
  4. SSSSSSSSWWWWAAAAPPPP((((3333SSSS))))                                                            SSSSSSSSWWWWAAAAPPPP((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SSSSSSSSWWWWAAAAPPPP, DDDDSSSSWWWWAAAAPPPP, CCCCSSSSWWWWAAAAPPPP, ZZZZSSSSWWWWAAAAPPPP - Swaps two real or complex vectors
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      Single precision
  13.  
  14.           Fortran:
  15.                CCCCAAAALLLLLLLL SSSSSSSSWWWWAAAAPPPP ((((_n,,,, _x,,,, _i_n_c_x,,,, _y,,,, _i_n_c_y))))
  16.  
  17.           C/C++:
  18.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  19.                vvvvooooiiiidddd sssssssswwwwaaaapppp ((((iiiinnnntttt _n,,,, ffffllllooooaaaatttt *_x,,,, iiiinnnntttt _i_n_c_x,,,, ffffllllooooaaaatttt *_y,,,, iiiinnnntttt _i_n_c_y))));;;;
  20.  
  21.      Double precision
  22.  
  23.           Fortran:
  24.                CCCCAAAALLLLLLLL DDDDSSSSWWWWAAAAPPPP ((((_n,,,, _x,,,, _i_n_c_x,,,, _y,,,, _i_n_c_y))))
  25.  
  26.           C/C++:
  27.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  28.                vvvvooooiiiidddd ddddsssswwwwaaaapppp ((((iiiinnnntttt _n,,,, ddddoooouuuubbbblllleeee *_x,,,, iiiinnnntttt _i_n_c_x,,,, ddddoooouuuubbbblllleeee *_y,,,, iiiinnnntttt _i_n_c_y))));;;;
  29.  
  30.      Single precision complex
  31.  
  32.           Fortran:
  33.                CCCCAAAALLLLLLLL CCCCSSSSWWWWAAAAPPPP ((((_n,,,, _x,,,, _i_n_c_x,,,, _y,,,, _i_n_c_y))))
  34.  
  35.           C/C++:
  36.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  37.                vvvvooooiiiidddd ccccsssswwwwaaaapppp(((( iiiinnnntttt _n,,,, ssssccccssssllll____ccccoooommmmpppplllleeeexxxx *_x,,,, iiiinnnntttt _i_n_c_x,,,, ssssccccssssllll____ccccoooommmmpppplllleeeexxxx *_y,,,,
  38.                iiiinnnntttt _i_n_c_y))));;;;
  39.  
  40.           C++ STL:
  41.                ####iiiinnnncccclllluuuuddddeeee <<<<ccccoooommmmpppplllleeeexxxx....hhhh>>>>
  42.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  43.                vvvvooooiiiidddd ccccsssswwwwaaaapppp ((((iiiinnnntttt _n,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_x,,,, iiiinnnntttt _i_n_c_x,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>>
  44.                *_y,,,, iiiinnnntttt _i_n_c_y))));;;;
  45.  
  46.      Double precision complex
  47.  
  48.           Fortran:
  49.                CCCCAAAALLLLLLLL ZZZZSSSSWWWWAAAAPPPP ((((_n,,,, _x,,,, _i_n_c_x,,,, _y,,,, _i_n_c_y))))
  50.  
  51.           C/C++:
  52.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  53.                vvvvooooiiiidddd zzzzsssswwwwaaaapppp ((((iiiinnnntttt _n,,,, ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx *_x,,,, iiiinnnntttt _i_n_c_x,,,, ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx *_y,,,,
  54.                iiiinnnntttt _i_n_c_y))));;;;
  55.  
  56.           C++ STL:
  57.                ####iiiinnnncccclllluuuuddddeeee <<<<ccccoooommmmpppplllleeeexxxx....hhhh>>>>
  58.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  59.                vvvvooooiiiidddd zzzzsssswwwwaaaapppp ((((iiiinnnntttt _n,,,, ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>> *_x,,,, iiiinnnntttt _i_n_c_x,,,,
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSSSSSWWWWAAAAPPPP((((3333SSSS))))                                                            SSSSSSSSWWWWAAAAPPPP((((3333SSSS))))
  71.  
  72.  
  73.  
  74.                ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>> *_y,,,, iiiinnnntttt _i_n_c_y))));;;;
  75.  
  76. IIIIMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  77.      These routines are part of the SCSL Scientific Library and can be loaded
  78.      using either the ----llllssssccccssss or the ----llllssssccccssss____mmmmpppp option.  The ----llllssssccccssss____mmmmpppp option
  79.      directs the linker to use the multi-processor version of the library.
  80.  
  81.      When linking to SCSL with ----llllssssccccssss or ----llllssssccccssss____mmmmpppp, the default integer size is
  82.      4 bytes (32 bits). Another version of SCSL is available in which integers
  83.      are 8 bytes (64 bits).  This version allows the user access to larger
  84.      memory sizes and helps when porting legacy Cray codes.  It can be loaded
  85.      by using the ----llllssssccccssss____iiii8888 option or the ----llllssssccccssss____iiii8888____mmmmpppp option. A program may use
  86.      only one of the two versions; 4-byte integer and 8-byte integer library
  87.      calls cannot be mixed.
  88.  
  89.      The C and C++ prototypes shown above are appropriate for the 4-byte
  90.      integer version of SCSL. When using the 8-byte integer version, the
  91.      variables of type iiiinnnntttt become lllloooonnnngggg lllloooonnnngggg and the <<<<ssssccccssssllll____bbbbllllaaaassss____iiii8888....hhhh>>>> header
  92.      file should be included.
  93.  
  94. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  95.      SSSSSSSSWWWWAAAAPPPP/DDDDSSSSWWWWAAAAPPPP swaps two real vectors.
  96.  
  97.      CCCCSSSSWWWWAAAAPPPP/ZZZZSSSSWWWWAAAAPPPP swaps two complex vectors.
  98.  
  99.      These routines perform the following vector operation:
  100.  
  101.           x <-> y
  102.  
  103.  
  104.      where _x and _y are real or complex vectors.
  105.  
  106.      See the NOTES section of this man page for information about the
  107.      interpretation of the data types described in the following arguments.
  108.  
  109.      These routines have the following arguments:
  110.  
  111.      _n         Integer.  (input)
  112.                Number of vector elements to be swapped.  If _n <= 0, these
  113.                routines return without any computation.
  114.  
  115.      _x         Array of dimension (_n-1) * |_i_n_c_x| + 1.  (input and output)
  116.                SSSSSSSSWWWWAAAAPPPP: Single precision array.
  117.                DDDDSSSSWWWWAAAAPPPP: Double precision array.
  118.                CCCCSSSSWWWWAAAAPPPP: Single precision complex array.
  119.                ZZZZSSSSWWWWAAAAPPPP: Double precision complex array.
  120.                Vector to be swapped.
  121.  
  122.      _i_n_c_x      Integer.  (input)
  123.                Increment between elements of _x.
  124.                If _i_n_c_x = 0, the results will be unpredictable.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSSSSSWWWWAAAAPPPP((((3333SSSS))))                                                            SSSSSSSSWWWWAAAAPPPP((((3333SSSS))))
  137.  
  138.  
  139.  
  140.      _y         Array of dimension (_n-1) * |_i_n_c_y| + 1.  (input and output)
  141.                SSSSSSSSWWWWAAAAPPPP: Single precision array.
  142.                DDDDSSSSWWWWAAAAPPPP: Double precision array.
  143.                CCCCSSSSWWWWAAAAPPPP: single precision omplex array.
  144.                ZZZZSSSSWWWWAAAAPPPP: Double precision complex array.
  145.                Vector to be swapped.
  146.  
  147.      _i_n_c_y      Integer.  (input)
  148.                Increment between elements of _y.  If _i_n_c_y = 0, the results will
  149.                be unpredictable.
  150.  
  151. NNNNOOOOTTTTEEEESSSS
  152.      These routines are Level 1 Basic Linear Algebra Subprograms (Level 1
  153.      BLAS).
  154.  
  155.      When working backward (_i_n_c_x < 0 or _i_n_c_y < 0), each routine starts at the
  156.      end of the vector and moves backward, as follows:
  157.  
  158.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)), ..., _x(1)
  159.  
  160.           _y(1-_i_n_c_y * (_n-1)), _y(1-_i_n_c_y * (_n-2)), ..., _y(1)
  161.  
  162.    DDDDaaaattttaaaa TTTTyyyyppppeeeessss
  163.      The following data types are described in this documentation:
  164.  
  165.           TTTTeeeerrrrmmmm UUUUsssseeeedddd                     DDDDaaaattttaaaa ttttyyyyppppeeee
  166.  
  167.      Fortran:
  168.  
  169.           Array dimensioned _n           xxxx((((nnnn))))
  170.  
  171.           Integer                       IIIINNNNTTTTEEEEGGGGEEEERRRR (IIIINNNNTTTTEEEEGGGGEEEERRRR****8888 for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]])
  172.  
  173.           Single precision              RRRREEEEAAAALLLL
  174.  
  175.           Double precision              DDDDOOOOUUUUBBBBLLLLEEEE PPPPRRRREEEECCCCIIIISSSSIIIIOOOONNNN
  176.  
  177.           Single precision complex      CCCCOOOOMMMMPPPPLLLLEEEEXXXX
  178.  
  179.           Double precision complex      DDDDOOOOUUUUBBBBLLLLEEEE CCCCOOOOMMMMPPPPLLLLEEEEXXXX
  180.  
  181.      C/C++:
  182.  
  183.           Array dimensioned _n           xxxx[[[[_n]]]]
  184.  
  185.           Integer                       iiiinnnntttt (lllloooonnnngggg lllloooonnnngggg for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]])
  186.  
  187.           Single precision              ffffllllooooaaaatttt
  188.  
  189.           Double precision              ddddoooouuuubbbblllleeee
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. SSSSSSSSWWWWAAAAPPPP((((3333SSSS))))                                                            SSSSSSSSWWWWAAAAPPPP((((3333SSSS))))
  203.  
  204.  
  205.  
  206.           Single precision complex      ssssccccssssllll____ccccoooommmmpppplllleeeexxxx
  207.  
  208.           Double precision complex      ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx
  209.  
  210.      C++ STL:
  211.  
  212.           Array dimensioned _n           xxxx[[[[_n]]]]
  213.  
  214.           Integer                       iiiinnnntttt (lllloooonnnngggg lllloooonnnngggg for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]])
  215.  
  216.           Single precision              ffffllllooooaaaatttt
  217.  
  218.           Double precision              ddddoooouuuubbbblllleeee
  219.  
  220.           Single precision complex      ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>>
  221.  
  222.           Double precision complex      ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>>
  223.  
  224. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  225.      IIIINNNNTTTTRRRROOOO____SSSSCCCCSSSSLLLL(3S), IIIINNNNTTTTRRRROOOO____BBBBLLLLAAAASSSS1111(3S)
  226.  
  227.      IIIINNNNTTTTRRRROOOO____CCCCBBBBLLLLAAAASSSS(3S) for information about using the C interface to Fortran 77
  228.      Basic Linear Algebra Subprograms (legacy BLAS) set forth by the Basic
  229.      Linear Algebra Subprograms Technical Forum.
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.                                                                         PPPPaaaaggggeeee 4444
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.